Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Setting Up Transformation Matrices

Q3Matrix4x4_SetRotateAboutPoint

You can use the Q3Matrix4x4_SetRotateAboutPoint function to configure a 4-by-4 rotation transformation matrix.

TQ3Matrix4x4 *Q3Matrix4x4_SetRotateAboutPoint (
TQ3Matrix4x4 *matrix4x4, 
const TQ3Point3D *origin, 
float xAngle, 
float yAngle, 
float zAngle);

matrix4x4

A 4-by-4 matrix.

origin

The desired origin of rotation.

xAngle

The desired angle of rotation around the x component of origin, in radians.

yAngle

The desired angle of rotation around the y component of origin, in radians.

zAngle

The desired angle of rotation around the z component of origin, in radians.

DESCRIPTION

The Q3Matrix4x4_SetRotateAboutPoint function returns, as its function result and in the matrix4x4 parameter, a rotation matrix that rotates an object by the specified angle around the point origin.